home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBP.ADF / BootPic / BootPic.doc < prev    next >
Text File  |  1991-06-20  |  9KB  |  214 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV1.0                                 *
  4. *                                                                             *
  5. *                         ⌐ 1991 by Andreas Ackermann                         *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. CONTENTS:______________________________________________________________________
  10.  
  11.  
  12.        1. About shareware
  13.        2. Introduction
  14.        3. Installation
  15.        4. About the Parser
  16.        5. Kompatibility
  17.        6. What happens after resetting the machine ?
  18.        7. Possible sources of errors
  19.        8. About the programming
  20.  
  21. _______________________________________________________________________________
  22.  
  23. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡
  24. SHAREWARE-CONDITIONS:
  25.  
  26.     BootPic is SHAREWARE. You are allowed to copy BootPic as long as the
  27.     following conditions are kept :
  28.  
  29.     o  BootPic mustn't be changed
  30.     o  This DOC-file must be included
  31.     o  It mustn't be charged any fee (besides fees for copying or disks etc.)
  32.  
  33.     If you like BootPic and if you use it regularly or if you include parts of
  34.     the source in your own programms (e.g. the fading-routines) please feel free
  35.     to send me a small donation of 5$ or 5DM.
  36.  
  37.     If you want to use BootPic as part of a commercial programme, you need my
  38.     written permission.
  39.  
  40.     My Address:            Andreas Ackermann
  41.                            Lorenz-Summa-Str.10
  42.                            W-8679 Oberkotzau
  43.                            GERMANY
  44.                            Tel.:09286/6399
  45.  
  46. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡
  47. Please note:
  48. I wrote this software instead of doing a holiday job. If I'm able to earn some
  49. money in this way, other programmes and updates will follow (e.g. color-cycling,
  50. intuition-interface, or how about installing libraries resident [useful with
  51. arp.library] or a programme to generate Videotitles ?
  52.  
  53.  
  54.                                INTRODUCTION
  55.  
  56. Do you belong to the group of people who think the ½Workbench-hand╗ that
  57. appears after every reset to be boring ?
  58. Then BootPic is the right thing for you. It allows you to load (nearly) any
  59. IFF-ILBM-picture instead of the ½hand╗. (Overscan, HAM, Halfbright, etc.) It
  60. just has to be in compressed form. (e.g. DPaint saves its pictures in compressed
  61. form ).
  62. The installed programme uses 1K more memory than the length of the picture-file.
  63. [If there, it uses fast-memory]
  64.  
  65.                                INSTALLATION
  66.  
  67. BootPic can be started either from Workbench or CLI. It is controlled by
  68. commandline parameters.
  69. Particularities when started from WB :
  70.  
  71.  - The parameters have to entered in the window that opens.
  72.  - You MUST'T enter BootPic in front of the paramters.
  73.  - To exit from BootPic, simply enter one character and press RETURN.
  74.    If you want to specify the parameters again, simply press RETURN.
  75.  
  76.  
  77. The syntax is as follows :
  78.  
  79.                 BootPic -e | -l{IFF-File} [-s][-r][-c rgb]
  80.  
  81. -l{IFF-File}  Removes, if present, an old picture and then tries to install
  82.               a new one instead.
  83.  
  84.               Message if it had success:
  85.               ½Picture successfully installed. Have Fun !╗
  86.  
  87.               Possible faults:
  88.               ½Couldn't open Picture-File╗
  89.               ½This is not an ILBM-Picturefile╗
  90.               ½Picture is not compressed╗
  91.               ½Warning:Couldn't find CAMG-Chunk╗
  92.               CAMG-Chunk not found : The viewmodes are saved in this chunk
  93.               [e.g. Hires or Interlace etc.]. Until Kickstart 1.3 the picture
  94.               will be shown correctly despite of CAMG's missing.
  95.               [RESTRICTION: instead of Halfbright, HAM will be selected.]
  96.               ½BODY-Chunk not found╗
  97.               ILBM-File didn't contain image-data (should never happen).
  98.               ½Memlist corrupt. Something went totally wrong╗
  99.               Meaning see at -e
  100.               ½Not enough Memory╗
  101.  
  102. -e            Removes, if present, an old picture.
  103.  
  104.               Message if successful:
  105.               ½Removed BootPic from List╗
  106.  
  107.               Possible faults:
  108.               ½BootPic not installed. Couldn't remove it╗
  109.               ½Memlist corrupt. Something went totally wrong╗
  110.               BootPic discovered its memory, but it couldn't find its entry in
  111.               the resident table (should never happen).
  112.  
  113.               The following parameters work only together with -l :
  114.  
  115. -s            loads the file specified by -l only if BootPic is not yet
  116.               installed. In this way it is possible to use BootPic in the
  117.               Startup-Sequence.
  118.  
  119.               If BootPic was already installed it prints out :
  120.               ½BootPic already installed. Changed nothing.╗
  121.  
  122. -r            BootPic resets the machine after loading the picture.
  123.  
  124. -c            here you can specify the color which should be faded in after
  125.               showing the picture. Normally this is the background color of
  126.               your Workbench-Screen. The values of r,g and b must be specified
  127.               hexadecimal, so values from 0-9 and a-f are valid. [0 means that
  128.               this component isn't there at all and f means that it is there at
  129.               maximum idensity. (e.g. -c000 for black, -ce50 for orange).
  130.               Invalid values are accepted but the result will be other than
  131.               expected.
  132.               Default: 05a [Amiga-blue]
  133.  
  134.  
  135. EXAMPLE:
  136. ¡¡¡¡¡¡¡¡   To install the picture that is included on this Disk, do the
  137.            following steps:
  138.            Put this disk in df0: , load BootPic via Workbench by double-click
  139.            on its icon and enter the following line :
  140.            -l df0:bootpic/demo.pic
  141.            After resetting and removing any disks in df0: you can watch the
  142.            picture.
  143.  
  144.                                 ABOUT the PARSER
  145.  
  146.  All parameters may be specified either as small or capital letters. Every
  147.  parameter MUST start with ½-╗, the order is at pleasure. Between the single
  148.  parmeters any number of spaces may be typed .
  149.  
  150.  Valid calls would be :
  151.  
  152.   bootpic  -l  :BootPic/demo.pic -R   -c  7aB
  153.  
  154.   bootpic -E
  155.  
  156.   bootpic -cAE3  -S -l:bootpic/demo.pic
  157.  
  158.  If -e or -l aren't specified, or if something else was typed wrong, BootPic
  159.  shows the usage.
  160.  If -e AND -l are specified, BootPic acts as if just -e was specified.
  161.  
  162.                                  KOMPATIBILTY
  163.  
  164.  BootPic installs itself in a ½kindly╗ way, that means that any other resident
  165.  programme won't  be removed, e.g. Guardian, CARD:, but also viruses.
  166.  In the same careful way it removes itself.
  167.  
  168.                    What happens after RESETTING the machine  ?
  169.  
  170.  When BootPic was successfully installed, the loaded picture will be faded in
  171.  softly whenever there's no bootable disk in df0: .
  172.  When inserting a bootable disk the colors will be faded softly to the color
  173.  specified under -c and your system starts as usual .
  174.  [The fading of HAM-pictures looks a little bit curious but that's NO bug.]
  175.  If you press the left mouse button while the picture is shown, the usual
  176.  workbench-hand appears.
  177.  
  178.                          Possbile SOURCES of ERRORS
  179.  
  180.  Normally a picture that was once installed, stays in memory until you remove
  181.  it with -e or till you switch off your Amiga.
  182.  But there are some exceptions:
  183.  
  184.   a.)  If you play a game that believes all the memory belongs to itsself, it
  185.        is possible that the memory allocated by BootPic is overwritten.
  186.        Then you won't see the picture any more.
  187.   b.)  Many viruses simply overwrite the reset-vectors. In this case BootPic
  188.        will be gone, too.
  189.   c.)  Some virusdedectors (e.g. ATool) are of the opinion that every resident
  190.        programme is a virus, so BootPic will be removed, too.
  191.  
  192.  If one of these cases should arise, it may be possible, that you get a GURU
  193.  after a reset. If you can't remove it by clicking the left mousebutton,
  194.  switching off the Amiga is the only thing you can do.
  195.  
  196.                                 PROGRAMMING
  197.  
  198.  BootPic was written with the Devpac 2.14D - Assembler, that's the reason for
  199.  its small code size [less than 4K ].
  200.  [For more information look into source-code ].
  201.  Many thanks go to JM Forgeas for the wonderful editor AZ V1.50.
  202.  
  203.  BootPic works well under Kickstart V1.2 and 1.3, but I wasn't able to test it
  204.  under Kickstart 2.0.
  205.  I am very thankful for critics, propositions and BUG-reports. If you expect a
  206.  reply letter PLEASE send an extra DM or $ for postage.
  207.  
  208.                          ENJOY !
  209.  
  210.   Oberkotzau, april 1st 1991                    Andreas Ackermann [*10.07.1974]
  211.   [ excuse my mistakes !!! ]
  212.  
  213.  
  214.